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Introduction 



Section 1 
Introduction 



1.1 GENERAL INFORMATION 

Be sure to copy this master. For copy procedures, refer 
DNOS System Operations Guide part number 2270502-9701. 



to the 



All system command interpreter (SCI) commands in this document 
are given in abbreviated form and may be executed by entering the 
command exactly as is, or by using the interactive prompting from 
the SCI. For a discussion of the abbreviated command form, refer 
to the DNOS System Command Interpreter (SCI) Reference Manual , 
part number 2270503-9701. 



1.2 MEDIA DEFINITION 

Product shipments are made in three formats: 

* Disk - A DS10, DS25, DS300, DS50, CD1400, DS80 or DS200 
disk pack or two dual-sided, double density diskettes 
that contain the object. 

* Magnetic Tape - An 800 or 1600 bpi magnetic tape reel or 
a 1600 bpi magnetic tape cartridge that contains the 
object. 

* Add -On - A disk pack that contains the source and one or 
more other products on the same disk pack. 

The installation instructions in this document assume that the 
object files are on a disk named DBMS990N or a directory named 
.DBMS990N. Section 2 describes how to prepare the media for 
installation. 
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1.3 THE INSTALLATION PROCEDURE 

The object media contains the files and batch streams to perform 
the following: 

* Generate a data base configuration 

* Install the newly configured system on your DNOS system 

* Verify the installation 

1.4 SYSTEM REQUIREMENTS 

To successfully perform this installation procedure, you must 
have a functioning DNOS l.X system. 
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Section 2 
Preparing for Installation 



2 . 1 INTRODUCTION 

Before executing the installation instructions, the object files 
must be prepared so that the batch stream can access them. The 
following paragraphs describe how to prepare each media. 



2.2 DISK FORMAT 

When the object is received on a disk or diskette, the following 
steps will prepare it for generation and installation. 

1. For disks: 

a. Put the installation disk in an available disk 
drive on a functioning DNOS l.X system and load 
it. 

b. Install the disk using the following command: 

IV U=DSxx, V=DBMS990N 

In this command, DSxx will be the disk drive on 
which DBMS990N has been loaded. 

Proceed to Section 3 for instructions for 
generating DBMS-990. 

2. For diskettes: 

a. Load the disk on which you want the object files 
installed. 

b. Install this disk using the following command: 

IV U=DSxx, V=<volume name> 

In this command, DSxx is the name of the disk 
drive in which you loaded the disk and <volume 
name> is the name of the disk on which you want 
the object files installed. 
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c. Load the diskette named DBMSDDlN in an available 
disk drive. 

d. Install the diskette using the following command: 

IV U=DSXX, V=DBMSDD1N 

In this command, DSxx is the name of the disk 
drive in which you loaded the diskette. 

e. To place the files in a directory, create a 
directory using the following command: 

CFDIR P=<volume name> .DBMS990N, M=100 

In this command, <volume name> is the disk on 
which you want the object files installed. 

f. Copy the contents of DBMSDDlN to the disk or 
directory using the following command: 

CD I=DBMSDDlN, 0=<pathname> , L=.LISTING1 

In this command, <pathname> is the pathname of 
the disk or directory on which you want the 
object files installed. 

g. When the copy is complete, unload the diskette 
and load the diskette named DBMSDD2N. 

h. Install the diskette using the following command: 

IV U=DSxx, V=DBMSDD2N 

In this command, DSxx is the disk drive in which 
the DBMSDD2N diskette was loaded. 

i. Copy the contents of this diskette to the disk or 
directory using the following command: 

CD I=DBMSDD2N, 0=<pathname> , L=.LISTING2 

In this command, <pathname> is the pathname of 
the disk or directory on which you want the 
object files installed. 

Proceed to Section 3 for instructions for generating DBMS-990. 
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2.3 MAGNETIC TAPE FORMAT 

When the object is received on a magnetic tape reel or magnetic 
tape cartridge, you must first move the files to a disk before 
beginning the installation process. To do this: 

1. Load the disk on which you want the object files 
installed. 

2. Install this disk using the following command: 

IV U=DSxx, V=< volume name> 

In this command, DSxx is the name of the disk drive in 

which you loaded the disk and <volume name> is the name 

of the disk on which you want the object files 
installed. 

3. To place the files in a directory, create a directory 
using the following command: 

CFDIR P=<volume name >. DBMS 9 9 ON, M=100 

In this command, <volume name> is the disk on which you 
want the object files installed. 

4. Load the magnetic tape reel or magnetic tape cartridge. 

5. Move the contents of the magnetic tape reel or magnetic 
tape cartridge to your disk or directory using the 
following command: 

RD S=MTxx, D=<pathname>, L=. LISTING 

In this command, <pathname> is the pathname of the disk 
or directory on which you want the object files 
installed. The file .LISTING now contains a listing of 
the directory restored from the magnetic tape. This 
file can be examined by executing a Show File (SF) or a 
Print File (PF) command. 

6. Unload the magnetic tape reel or magnetic tape 
cartridge. 

Proceed to Section 3 for instructions for generating DBMS-990. 
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2.4 ADD-ON FORMAT 

When you receive the object as an add-on package, use the 
following steps to prepare it for installation: 

1. Put the add-on disk in an available disk drive on a 
functioning DNOS l.X system and load it. 

2. Install the disk using the following command: 

IV U=DSxx f V=<volume name> 

In this command, DSxx is the disk drive on which the 
volume was loaded and <volume name> is the volume name 
of the add-on disk. The volume name will be marked on 
the disk or you can execute a Show Volume Status (SVS) 
command to obtain the volume name. 

3. Load the disk on which you want the object files 
installed. 

4. Install this disk using the following command: 

IV U=DSxx, V=< volume name> 

In this command, DSxx is the name of the disk drive in 
which you loaded the disk and <volume name> is the name 
of the disk on which you want the object files 
installed. 

5. To place the files in a directory, create a directory 
using the following command: 

CFDIR P=<volume name > .DBMS 9 9 ON, M=100 

In this command, <volume name> is the disk on which you 
want the object files installed. 

6. Copy the DBMS990N directory from the add-on disk to the 
disk or directory on which you want the object files 
installed using the following command: 

CD I=<volume name > .DBMS 9 9 ON, 0=<pathname> , L=. LISTING 

In this command, < volume name> is the name of the add- 
on disk and <pathname> is the pathname of the disk or 
directory on which the object files will be installed. 

Proceed to Section 3 for instructions for generating DBMS-990. 
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Section 3 
Generating DBMS-990 



This section describes the procedure for generating a DBMS-990 
configuration. The procedure is as follows: 

1. Select the alternate procedure library by entering the 
following commands: 

.OPTION MENU=LC 

.USE DBMS990N.S$CMDS,.S$CMDS 

2. Execute the generation procedure using the DBGEN 
command. This command is described in the Model 990 
Computer DNOS Data Base Administrator User^s Guide, 
part number 227 2059-9701. The DBMS990N disk should not 
be write protected. 

The DBGEN procedure executes in foreground for 
approximately two minutes and then returns to the SCI 
menu. If no errors are reported, a batch stream will 
have begun in background. This batch stream executes 
for approximately 20 minutes on a quiet system. Use 
the Wait (WAIT) command to wait for completion of the 
batch stream. 

When the batch stream completes, the following messages 
are displayed: 

I SCI- 00 49 BATCH SCI HAS COMPLETED 

I MAIL-0001 RECEIVED <time, day, month, year> 
FENERATION OF DBMS-990 COMPLETE WITH n ERRORS 

In this message, n indicates the number of errors. If 
errors have occurred, other messages indicate which 
files to check to determine the cause of the errors. 

3. If no errors occurred in the batch stream, text edit 
the patch file using the following command: 

XE F=DBMS990N. BATCH. DNOS. PATCH 

Instructions for editing the patch file are given at 
the beginning of the file. 
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The DBMS990N disk is now a master disk. This disk may be used 
for all installation procedures. The disk includes a file, 
DBMS 99 ON. CONFIG, that describes the generated configuration. You 
may look at this file using a Show File (SF) command or print it 
using a Print File (PF) command. 

When this process has completed successfully, exit from this mode 
using the following command: 

.USE 

This returns the SCI menu and allows you to unload the DBMS-990 
installation disk. 
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Section 4 
Installing DBMS-990 



This section describes the procedure to install DBMS-990 on your 
DNOS system. The procedure performs the following: 

* Deletes the existing DBMS 

* Installs the procedures and tasks required for DBMS 
The procedure steps are as follows: 

1. The SCI procedures that are installed during this 
installation process cannot be used unless the logical 
name S$DBMS is assigned. Assign S$DBMS using the 
following command: 

ALN L=S$DBMS, A=.S$DBMS 

In this command, ,S$DBMS is the pathname of the 
directory that contains the program file. 

The logical name assigned in this way is set for your 
user ID while you are logged on. Once you log off, the 
logical name becomes permanently assigned and can be 
used whenever you log on. 

To set the logical name so that it is set for all users 
who log on your system, text edit the file .S$CMDS.M$00 
adding the following command to the file: 

ALN L=S$DBMS, A=.S$DBMS 

In this command, .S$DBMS is the pathname of the 
directory that contains the program file. 

To use the logical name, log off your system and log on 
your system again. Each user who logs on your system 
can use this logical name. As the users log off the 
system, the logical name will become permanently 
assigned for use by that user. When all the users on 
your system have logged on and logged off, you may 
delete the ALN command from ,S$CMDS.M$00. 

2. Select the alternate procedure library using the 
following commands: 
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.OPTION MENU=LC 

.USE DBMS990N.S$CMDS f .S$CMDS 

3. Execute the installation procedure using the DBINS 
command. This command is described in the Model 990 
Computer DNOS Data Base Administrator User^s Guide, 
part number 2272059-9701. Before executing the 

command, make sure that the data base is not running 
and that the DBMS990N disk is not write protected. 

This process executes in the foreground briefly and then 
continues in background for approximately 20 minutes on a quiet 
system. Enter the Wait (WAIT) command to wait for completion. 

When the execution has completed the following messages are 
displayed: 

I SCI-0049 BATCH SCI HAS COMPLETED 

I MAIL-0001 RECEIVED <time, day, month, year> 
: DBMS- 990 INSTALLATION COMPLETED WITH n ERRORS 

In this message, n indicates the number of errors. If errors 
have occurred, other messages indicate which files to check to 
determine the cause of the errors. 

When this process has completed successfully, exit from 
installation mode using the following command: 

.USE 

This returns the SCI menu and allows you to unload the DBMS-990 
installation disk. 

Proceed to Section 5 to verify the installation of DBMS-990. 
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Section 5 
Verifying the Installation 



Read the Release Information guide for DNOS DBMS-990 and install 
any required patches before proceding with this section. Perform 
the following steps to ensure that DBMS-990 has been properly 
installed: 

1. Start the data base by entering the SDBMS command and 
responding as follows: 

START DATA BASE MANAGER < VERSION 2.2.0> 
MAXIMUM ASSIGNED FILES: 
MAXIMUM OPEN FILES: 
LOG FILE BLOCKING FACTOR: 



NOTE 

The LOG FILE BLOCKING FACTOR prompt appears 
only if transacations were not included 
during system generation. 



The following screen then appears: 

OPEN DBMS-990 LOG FILE 

LOGGING ACCESS NAME: DUMY 

Respond as shown. 

Assign the data base test file by entering the ADBF 
command and responding as follows: 

ASSIGN DATA BASE FILE ID 

FILE ID: TEST 
DB FILE PATHNAME: S$DBMS. TEST. DATABASE 

Execute Primitive Query by entering the PQUERY command. 
The following prompts appear : 

PASSWORD : 
LISTING ACCESS NAME: 

Do not respond to the LISTING ACCESS NAME: prompt. 
The PASSWORD: prompt will be displayed only if 
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security is installed. If the PASSWORD: prompt is 
displayed, respond to it with the password you used to 
install security. 

After you complete this menu, the following menu will 
appear : 

PRIMITIVE QUERY 

FUNCTION: RS 
FILE ID: TEST 
KEY ID: KEY 
KEY VALUE: 
FIELD IDS: TEXT 
NO. OF OUTPUT LINES: 

TERMINATE: YES 

Respond to the menu as shown. 

The output from this command should be as in the 
following : 



LINE TYPE IS: 02 

KEY TEXT 

TEST KEY 

TEST KEY THE OUTPUT OF THIS TEXT INDICATES THAT 

TEST KEY DBMS-990 HAS BEEN INSTALLED AND SATISFIES 

TEST KEY THIS TEST PROCEDURE. 

TEST KEY 

========= END OF DATA LINES ========= 



The test procedure will leave the test data base file, TEST, 
open. You may close this file or stop the data base manager, 
which will automatically close this file. 

Appendix B of the Model 990 Computer DNOS Data Base Management 
System Programmer's Guide, part number 227 2058-9701 provides 
further information about executing example programs. If the 
installation has been verified you can delete the directory 
S$DBMS.TEST to save space. 
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Section 6 
Removing DBMS-990 



The following procedure will remove the installed DBMS-990 from 
your system. DBMS-990 must not be active and DD-990 cannot be 
installed when this procedure is executed. 

1. Issue the following command: 

.USE DBMS990N.S$CMDS, .S$CMDS 

2. Enter the DBERASE command and answer the following 
prompts to delete DBMS-990: 

ERASE INTALLED DBMS990 

VOLUME NAME: 

LISTING ACCESS NAME: 

In this command, the VOLUME NAME prompt must contain 
the name of the disk on which DBMS-990 is installed. 

When this command has completed, all DBMS-990 
procedures, tasks, and command procedures have been 
deleted from your system. 



2272092-9701 6-1/6-2 Texas Instruments 



